<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt-br" lang="pt-br">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Assistente de String : Guia do Usuário CodeIgniter</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv="expires" content="-1" />
<meta http-equiv="pragma" content="no-cache" />
<meta name="robots" content="all" />
<meta name="author" content="ExpressionEngine Dev Team" />
<meta name="description" content="Guia do Usuário do CodeIgniter" />

</head>
<body>

<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Alternar Tabela de Conteúdos" alt="Alternar Tabela de Conteúdos" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>Guia de Usuário CodeIgniter Versão 2.0.0</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">Tabela de Conteúdos</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.com.br/">Página Inicial</a> › 
<a href="../index.html">Guia de Usuário CodeIgniter</a> › Assistente de String
</td>
<td id="searchbox"><form method="get" action="http://www.google.com.br/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.com.br/manual/" />Busca <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" /> <input type="submit" class="submit" name="sa" value="Ok" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->

<br clear="all" />


<!-- START CONTENT -->
<div id="content">


<h1>Assistente de String</h1>

<p>O arquivo Assistente de String contém funções que auxiliam no trabalho com strings.</p>


<h2>Carregando este Assistente</h2>

<p>Este assistente é carregado usando o seguinte código:</p>
<code>$this->load->helper('string');</code>

<p>As funções disponíveis são as seguintes:</p>

<h2>random_string()</h2>

<p>Gera uma string randômica baseada no tipo e no comprimento que você especificar. Útil para criar senhas ou hashes randômicos.</p>

<p>O primeiro parâmetro especifica o tipo de string, o segundo especifica o comprimento. As seguintes opções estão disponíveis:</p>

 alpha, alunum, numeric, nozero, unique, md5, encrypt and sha1
<ul>
	<li><strong>alpha</strong>:&nbsp; Uma string com letrar em caixa alta e baixa.</li>
	<li><strong>alnum</strong>:&nbsp; String alfa-numérica com caracteres em caixa alta e baixa.</li>
	<li><strong>numeric</strong>:&nbsp; String numérica.</li>
	<li><strong>nozero</strong>:&nbsp; String numérica sem zeros.</li>
	<li><strong>unique</strong>:&nbsp; Encriptada com MD5 e uniquid(). Nota: O parâmetro de comprimento não é disponível para este tipo.
        Retorna uma string de comprimento fixo de 32 caracteres.</li>
	<li><strong>sha1</strong>:&nbsp; Um número aleatório criptografado com base no <kbd>do_hash()</kbd> do <a href="security_helper.html">ajudante de segurança</a>.</li>
</ul>

<p>Exemplo de Uso:</p>

<code>echo random_string('alnum', 16);</code>


<h2>alternator()</h2>

<p>Permite que dois ou mais itens alternem-se entre si quando dentro de um loop. Exemplo: </p>

<code>for ($i = 0; $i < 10; $i++)<br />
{<br />
&nbsp;&nbsp;&nbsp;&nbsp;echo alternator('string one', 'string two');<br />
}<br />
</code>

<p>Você pode adicionar quantos parâmetros quiser e a cada interação de seu loop o próximo ítem será retornado.</p>

<code>for ($i = 0; $i < 10; $i++)<br />
{<br />
&nbsp;&nbsp;&nbsp;&nbsp;echo alternator('one', 'two', 'three', 'four', 'five');<br />
}<br />
</code>

<p><strong>Nota:</strong> Para usar chamadas múltiplas separadas a esta função basta chamar a função sem argumento para reinicializá-la.</p>



<h2>repeater()</h2>
<p>Gera cópias repetidas dos dados que você enviar. Exemplo:</p>
<code>$string = "\n";<br />
echo repeater($string, 30);</code>

<p>O código acima gerará 30 novas linhas.</p>
<h2>reduce_double_slashes()</h2>
<p>Converte barras duplas em uma string para um barra simples, exceto aqueles encontrados em http://. Exemplo: </p>
<code>$string = &quot;http://example.com//index.php&quot;;<br />
echo reduce_double_slashes($string); // resulta em &quot;http://example.com/index.php&quot;</code>
<h2>trim_slashes()</h2>
<p>Remove as barras de inicio e final de uma string. Exemplo:<br />
	<br />
	<code>$string = &quot;/this/that/theother/&quot;;<br />
echo trim_slashes($string); // resulta em this/that/theother</code></p>


<h2>reduce_multiples()</h2>
<p>Reduz a várias instâncias de um determinado caractere ocorrendo imediatamente após o outro. Exemplo:</p>
<code>
$string="Fred, Bill,, Joe, Jimmy";<br />
$string=reduce_multiples($string,","); //resulta em "Fred, Bill, Joe, Jimmy"
</code>
<p>A função aceita os seguintes parâmetros:
<code>reduce_multiples(string: texto para pesquisar, string: caractere para reduzir, booleano: se deseja remover o caractere da frente e no fim do string)</code>

O primeiro parâmetro contém a string em que você deseja reduzir as multiplicações. O segundo parâmetro contém o caractere que você quer ter reduzido.
O terceiro parâmetro é FALSE por padrão; se definido como TRUE ele irá remover as ocorrências do caractere no início e no final da string. Exemplo:

<code>
$string=",Fred, Bill,, Joe, Jimmy,";<br />
$string=reduce_multiples($string, ", ", TRUE); //resulta em "Fred, Bill, Joe, Jimmy"
</code>
</p>

<h2>quotes_to_entities()</h2>
<p>Converte aspas simples e duplas em uma string para as entidades correspondentes de HTML. Exemplo:</p>
<code>$string="Joe's \"dinner\"";<br />
$string=quotes_to_entities($string); //resulta em "Joe&amp;#39;s &amp;quot;dinner&amp;quot;"
</code>

<h2>strip_quotes()</h2>
<p>Remove as aspas simples e duplas em uma string. Exemplo:</p>
<code>$string="Joe's \"dinner\"";<br />
$string=strip_quotes($string); //resulta em "Joes dinner"
</code>

</div>
<!-- END CONTENT -->


<div id="footer">
<p>
Tópico Anterior:&nbsp;&nbsp;<a href="smiley_helper.html">Assistente de Smiley</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">Topo da Página</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">Guia de Usuário CodeIgniter</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
Próximo Assunto:&nbsp;&nbsp;<a href="text_helper.html">Assistente de Texto</a>
</p>
<p><a href="http://codeigniter.com.br">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">EllisLab, Inc.</a></p>
</div>

</body>
</html>